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Getting Started 
Making a Working Copy 


The first thing you should do is make a working copy of the 
Eco-C C Compiler disk. If you use the CP/M PIP utility, the 
sequence is to place your CP/M disk with PIP on it in drive A and 
a blank, formatted disk in B. (We have used <CR> to signify 
pressing the RETURN key.) 


A>PIP <CR> 
* (now place the Eco-C disk in A) 
B:=A:*.* <CR> ( <---- and enter this line) 


(Use OV option for copyinh 


After the copy is completed, place the original disk ina safe 
Place and use the copy from now on. You will need the following 
files when compiling a program: 


CP.COM Macro Pre-processor 

XC.COM C Compiler 

XM.COM Code Generator 

CE.COM Error Reports 

CODE. PS Overhead Files 

CODE. PA . " 

ERR.PA " " 

STDIO.H Standard Definitions 

* REL Library Routines (All of them) 
M80.COM Microsoft's Macro Assembler 
L80.COM i Linker 


In addition, each compiled program will generate (on its own) 
TOKEN.CWK and PCODE.CWK as intermediate files during compilation. 
These intermediate files will be erased automatically as the 
compilation progresses. You probably will want to place your 
editor on the disk, too (e.g., the editor on your CP/M disk is 
named ED.COM). If you use a screen editor like Micropro's 
Wordstar, be sure you write your programs in the "non-document" 
mode. Finally, do not write programs using the file names above. 


If disk space is a problem, the files may have a maximum 
split as follows: 


DISK1 - CP.COM, XC.COM, XM.COM, CE.COM, CODE.PS, CODE.PA, 
ERR. PA 

DISK2 - M80.COM 

DISK3 - L80.COM, CFF.REL, CIF.REL, CFC.REL, CIC.REL, ECC.REL, 
EC2. REL 


Using the above distribution of files, DISK2 may be used for 
the source file, compiler output and assembler output. DISK1 is 
used for the compiler and the compiler working files; while DISK3 
is used for linking the output of the assembler and the compiler 
libraries. Depending on disk size, qroupings of the above disks 
may be done. For example, on a North Star system DISK2 and DISK3 
typically would be combined into one disk (e.g., a DISK2). 


Having made a working copy of the Eco-C compiler, you are 
ready to write and compile a C program. 


Features of Eco-C 


Before you start using the compiler, you should know what is 
and is not supported in this release. 


The full C syntax is supported except; 


a. bitfields 

b.initializers(Initializers should be available in 
April, 1983. Aggregate Initializers are supported.) 

c. parametized macros 

d. #line macro preprocessor directive 

e. in compound expression following a #if, macro ex- 
pansion is not done 


Most of the above will be available in subsequent releases of the 
compiler. We also expect additional optimization (we've concen- 
trated on longs and floats so far) to substantially shrink code 
size and increase speed. You must have a signed license agreement 
on file to be eligible for these updates. 


Facts, Suggestions and Programming Hints 


The following is a list of specifications and suggestions 
that may prove useful. Some represent "C spec" rules that are not 
obeyed by existing compilers and might cause an error message 
that would not be generated by other compilers. Others are limi- 
tations that will disappear shortly. 


l. unsigned long, unsigned char and unsigned short data 
types will generate an error message. 


2. stdin, stdout, stderr and stdlst equate to fd0, fdl, fd2, 
and fd3 respectively. (A file named INIT.ASM controls the number 
of fcb's and iob's that are generated plus setting the stack.) 


3. On function calls: 
a. A function parameter of float is automatically pro- 
moted to double and short or char goes to an int. 


b. A function cannot return a char; only an int, | 


unsigned, long, double, or pointer no matter how declared. 
c. Given the choice of char or int, make it an int. It 
avoids internal conversions, thus improving speed. 


4, To initialize a pointer (e.g., x_ptr) to a function 
(e.g., funcl()), the syntax must be: 


x_ptr = &funcl; 


5. A structure or union name can only have two things done 
with it: 1) take its address with the address operator in front 
of it, or 2) have a period and a member name following its name. 


6. Binding of structure members to a structure is absolute. 
If a pointer is to a structure sl and now you want to use it with 
s2, you must cast the pointer to s2 or we will generate an error 
message. 


7. If a function is not recursive, you are usually better 
off to declare variables as static rather than auto or register. 
If generates more efficient code. 


8. When using a large "switch" statement, place the most 
likely case last and the least likely first. 


9. Currently we do support nested comments. 


10. #include's may be nested only two deep. 


ll. Floating point numbers can have up to 17 significant 
digits. The range for the exponent is -38 to +38. At the present 
time, only binary arithmetic is supported (BCD is forthcoming). 


12. Floating point and long constants are combined at run 
time rather than compile time. This, too, will be fixed. 


13. All program source files must terminate with a carriage- 
return, linefeed pair (CR-LF). Failure to observe this will cause 
the error handler to produce odd results. 


ee A 
14. We do not yet have: lseek() oxr..unlink(}+ functions, and 


appending to a file. This will disappear when random files are 
finished. 


The majority of the limitations mentioned above will dis- 
appear very soon. The error handler treats all errors as fatal; 
there is no “cascading" of false error messages. When you do get 
an error, you will find that it does diagnose the error correct- 
ly. Finally, the library is a bit meager at present, but will 
grow shortly. 


We think you will find the Eco-C compiler more "UNIX-like" 
than most on the market. Further, it performs its error checking 
in strict compliance with the syntax defined by K&R. Finally, we 
have adhered to the function definitions presented in K&R as much 
as possible in a CP/M environment. 


Using the Eco-C C Compiler 


Writing the Source Program 


The first step is to write the C program using a text edi- 
tor. (CP/M provides an editor stored on disk as ED.COM.) Be sure 
that you do not use the document mode on some editors (e.q., 
Wordstar). The document mode can turn the high bit ON and produce 
mysterious results on occasion. 


Typically, the file extention given to a CP/M C source 
program is ".C" (e.g., TEST.C). This is not a requirement, how-~ 
ever. You may use any file extention you wish. 


Compiling the Program 


Assuming the compiler and the source program (e.g., TEST.C) 
is on drive A, the compiler is envoked by: 


A>CP TEST <CR> 7* Assumes a ".C" extention */ 


The program will supply the extention of ".C" if one is not 
Supplied when the preprocessor is envoked. If you supply a file 
extention (e.g., ".XXX"), it overrides the default (".C"). A 
different souce disk may be specified. For example, 


A>CP B:TEST <CR> 


The program will automatically load and run the next two 
passes of the compiler (XC and XM) if no errors are detected. The 
output of the final pass (i.e., XM) is an assembly language 
source file (e.g., TEST.MAC). This can be examined and modified 
if you wish. 


Compiler Switches 


-i This switch tells the compiler to use the integer 
version of the printf( function. It avoids pulling in the float- 
ing point library whenever printf() is used. If your program does 
not use floating point numbers, this option will produce smaller 
code size. 


AS an example, Suppose a source program is named TEST.C. To 
use it with this option, the compiler would be invoked with the 
following command line arguments: 


A>cp test -i 


causing the TEST program to use the integer version of printf(). 
Note that lower case letters may be used if you wish. 


-c This switch uses the library where getchar() and 
putchar() do direct BDOS calls to CP/M for input/output (1/0) 
rather than through getc() and putc(). This avoids console I/O 
from going through the file handlers thus generating smaller code 
size. It is envoked with the following command line arguments: 


A>cp test -c 


-O This switch is used to change the name of the output 
file and the drive on which it is written. For example: 


A>cp test -o b:test 
A>cp test ~-ob:test 


Both of the above examples are allowed. If a file type is added 
to the file name the default type of '.MAC' will not be used. 


~b This switch is used to turn off most of the messages 
and statistics the compiler generates. 


NOTE: All or part of the switches may be used when compiling 
a program. Each switch option in the command line must be sepa- 
rated one from the other by a blank space; the order is unimpor- 
tant. Examples 


A>cp test -i -c 


or 
A>cp test -c -i 


both produce the same results. 


Assembling the Program 


The assembler output file from the compiler (e.g., TEST.MAC) 
becomes the input file to the assembler. Your package includes 
Microsoft's Macro 80 assembler. It is envoked with the following 
command: 


A>M80 =TEST /* Note blank space */ 


Since M80 has a default file extention of .MAC, the assembler may 
be used with or without the .MAC extention. 


The output file from the assembler will be named TEST.REL. 
Further details about using M80 are in the Microsoft manual. 
NOTE: there must be a blank space between M80 and the equal sign 
(=) when the assembler is envoked for CP/M. 


Linking the Program 
ee Ne oh ee 
The .REL file from the assembler is then linked to the 
standard library routines (e.g., CF.REL, EC2.REL, etc.) by using 
the Microsoft linker (L80). A typical link would be: 


A>L80 TEST, TEST/N/E 


which causes TEST.REL to be the input file and produces an output 
file named TEST.COM. TEST.COM becomes the executable C program. 
The standard library routines are automatically searched. 


If you wanted the input file TEST.REL to have a command file 
name of PRICE.COM, the syntax would be: 


A>L80 TEST, PRICE/N/E 


Linking in Your Own Functions 


Suppose that you have compiled and assembled a function you 
wrote with the name DATE.C. The assembler would have generated a 
REL file named DATE.REL. Now you want to link the function into a 
program named TEST.C. The command arguments would be: 


A>L80 TEST, DATE, TEST/n/e 


| | { 
input .REL file---- J 0 Seeeeean output .COM file 
| 


-REL function(s) to be linked with program 


The first file name following 180 on the command line is the 
input file (.REL). The last file name (before the "/n/e") is the 
output (.COM) program file. In between these two file names are 
the (.REL) function(s) you want to link in with the program. Each 
must be separated from the other by a comma. 


Again, additional details on L80 are found in the Microsoft 
manual. 
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Reading and Writing Data files 


We have attempted to make file input and output (i.e., I/0) 
as consistent with the UNIX operating system as possible given 
the differences between it and CP/M. Below is an example of writ- 
ing to and then reading from a file using the Eco-C compiler. 
Both programs in source are included on your distribution disk. 


/* Writing an ASCII Data File */ 


#include "stdio.h" /* Include file overhead info */ 
#define CLEARS 12 /* Clear screen for ADDS Viewpoint */ 
#tdefine MAX 1000 7* Maximum number of characters */ 
main () 
int i; 
char c;3 
FILE *fp; 
putchar (CLEARS) ; /* Clear the screen */ 
if ((fp = fopen("TEXT.TXT", "w")) == NULL) { 
puts ("Can't open TEXT. TXT") ; 
exit(-l); /* Signals an Error */ 


} 


puts("Enter line of text and press RETURN: \n"); 

for (i = 0; (c = getchar()) != '\n' && i < MAX; ++i) 
puectc;. fps 

putc(CPMEOF, fp); /* Must write end-of-file */ 


fclose(fp); 


The program begins with the #include preprocessor directive 
to include the file I/O information needed to work with disk 
files. The #defines are used to define the clear screen code for 
an ADDS Viewpoint and set the maximum number of characters that 
can be entered. 


The main() function marks the beginning of the program and 
several variables are declared. The FILE typedef refers to the 
structure that is defined in stdio.h and is used to establish 
pointers to fp and fopen(). Generally, high-level file I/O will 
require the FILE declarations to be present in every program that 
works with disk files. The call to putchar(CLEARS) simply clears 
the screen in preparation for entering the text. 


If your terminal requires two or more characters to clear 
the screen, change the #define to be a string and change the 
putchar(CLEARS) statement to a puts(). For example, if you are 
using a SOROC terminal which uses an escape (033 octal) followed 
by an asterisk (*), the #define would be: #define CLEARS "\033*", 
You would then use puts(CLEARS) instead of putchar(CLEARS) since 
we are now treating CLEARS as a string. 


The if statement attempts to open a text file using the name 
TEXT.TXT in the ASCII "write" mode. If the file cannot be opened 
(i.e., fp returns a NULL), a message is displayed that the file 
cannot be opened and the program is aborted by the call to 
exit(). The -1 argument in the exit() function call is used to 
signal that some error occurred. 


If all went well, fp serves as our link with the file that 
waS just opened (e.g., TEXT.TXT). A prompt asks the user to enter 
a line of text, pressing RETURN when they have finished. Calls to 
getchar() take the characters from the keyboard and assign them 
to c. A check is made to see if the character was a newline 
(i.e., a '\n' which corresponds to pressing RETURN) or if i 
exceeds the maximum number of characters allowed (MAX). 


If the tests are passed, a call to putc() places character c 
into the buffer associated with fp. The for loop continues until 
MAX - 1 characters or RETURN is entered. When that happens, a 
final call is made to putc() using the CP/M end-of-file (0x1A) as 
the character. This is necessary when using the ASCII mode for 
disk files. 


A cali to fclose() writes the buffer to the disk and closes 
the file and the program ends. 


Reading an ASCII Text File 


The program to read the text file just created closely 
follows the program used to write the file. Notice that main() is 
called with two arguments: argc and argv. The argc variable is 
used to count the number of command line arguments (argument 
counter) used when the program was envoked. The argvI] variable 
is an array of pointers that points to what command line argu- 
ments were entered. 


For example, to read the TEXT.TXT file, this program is 
envoked with: 
A>READFILE TEXT, TXT<CR> 


where the <CR> represents pressing RETURN. 


10 


/* Reading an ASCII data file */ 


#include "stdio.h" /* Pull in the overhead info again */ 
#define CLEARS 12 /* Clear screen for ADDS viewpoint */ 


main(argc, argv) 
int argc; 
char *argv[]; 
{ 
char c; 
FILE *fp; 


putchar (CLEARS) ; 
if (arge != 2) { 


printf£("I need to know the file name. \n\n") ; 
printf ("Use: \n\nA>READFILE FILENAME. XXX") ; 


exit(-1); 

} 

if ((fp = fopen(argv[1], "r")) == NULL) f{ 
printf("Can't open file: ¢s", argv[1]); 
exit(-1); 


} 

while((c = getc(fp)) != EOF) 
putchar(c); 

fclose(fp); 


There are two arguments (argc = 2) and two pointers in 
argv[] (argv[0] pointing to READFILE and argv[1] pointing to 
TEXT.TXT). In the program, the arge is checked to make sure that 
two arguments were supplied when the program was envoked. If argc 
is not equal to 2, an error message is given and the program 
aborts. 


If the argument count is correct, we try to open the file in 
the ASCII "read" mode. If the file pointer (fp) returned from the 
call to fopen() is a NULL, an error message is given and the 
Program aborts. 


If a valid file pointer is returned, while while loop does 
repeated calls to getc() and assigns the character in the buffer 
to c. The call to putchar() displays the characters on the CRT. 
This continues until the end-of-file (EOF) is sensed, whereupon 
the file is closed and the program ends. 


It may be a worthwhile excercise to list stdio.h to see how 
the various symbolic constants are defined (e.g., FILE, NULL, 
EOF, etc.), although you probably will not need to know the 
details contained therein. 


ll 


What to Do if You Run Out of Memory 


Unlike many other C Compilers that are available, the Eco-C 
compiler does not require that the entire source code of the 
program to reside in memory. Even so, it is possible to "run out 
of memory". Usually, this is caused by overflowing the symbol 
table space. 


Space for the symbol table is allocated dynamically. As auto 
variables are compiled, they are treated as temporaries and 
"discarded" after the function has been compiled. Very long 
programs with a large number of global variables (i.e., extern 
storage class) or a very large function with many auto-type 
variables are the most likely to cause the symbol table to over- 
flow. 


If this happens, all is not lost. Simply break the source 
program into two separate source programs and then compile and 
link them together. 


For example, suppose your source program TEST.C runs out of 
memory during a compile. Further assume that you inspect TEST.C 
and find that the program can be split in half after a function 
definition named root(). 


Using your editor, create a new file called TEST1.C; this 
will be a new file. Now read in TEST.C and delete all of the 
lines from the beginning of the program to the start of the 
definition of root(). TEST1.C should now contain the “second 
half" of TEST.C. Save TEST1.C on disk. Now load TEST.C and delete 
everything from the definition of the root() function to the end 
of the program and save it on disk. 


Having done the above, TEST.C contains the "first half" of 
the original program and TEST1.C contains the "second half". Now 
compile and assemble the two separately and then link them to- 
gether to form one program. The sequence might look like: 


A>cp TEST 
A>cp TEST1 

A>m80 =TEST 

A>m80 =TEST1 

A>180 TEST, TEST1,TEST/n/e 


which creates an executable program named TEST.COM with both 
"halves" linked together. 
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Standard Library of C Functions 


Listed below are the functions that comprise the Eco-C 
Standard Function Library. Each function is described by name 
with any argument list that might be necessary for the function 
call. If the function returns a data type other than integer 
(i.e., int), the data type returned preceeds the function name. 
The functions are arranged in alphabetical order for easier 
reference. 


alloc() 


char *alloc(u) /* Request for storage */ 
unsigned u; 


Returns a pointer to u bytes of storage, where each byte is able 
to store one char. If the request for u bytes of storage cannot 
be satisfied, the pointer returned equals NULL (i.e., zero). 
Therefore, a non-zero pointer value returned from the call to 
alloc() means that u bytes of consecutive storage are available. 


atoi() 
atoi(s) /* Return integer of string */ 
char *s; 


Returns the integer value of the string pointed to by "*s". This 
function permits the input string to be in decimal, hex or octal 
using the standard C syntax for such values (e.g., "Oxff"). 


atol () 


long atol(s) 7* Return long of string */ 
char *s; 


Functions in the same manner as atoi(), except the returned value 
is a long rather than an int. 
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calloc() 


char *calloc(count, size) /* Request storage ud 
unsigned count, size; 


Returns a pointer to sufficient storage to for "count" items, 
each of which requires "Size" bytes of storage. If the request is 
successful, each byte is initialized to NULL. If the request for 
Storage cannot be satisfied, the pointer returned equals NULL 
(i.e., zero). The pointer returned, therefore, can be tested to 
see if the request was satisfied. 


decimal () 
long decimal(s) /* Return long of decimal */ 


char *s; 


Returns the long value of a decimal string pointed to by "*s", 


exit () 


int exit (i) /* terminate a program */ 
inet: <is 


Used to terminate a program. A non-zero value for "i" is normally 
used to indicate that some error occurred when this function was 
called. 


free () 


int free(c) /* Release storage area */ 
char *c; 


The function call frees (i.e., de-allocates) the region of stor- 
age pointed to by "c", thus making that area of storage available 
for re-use. The function assumes that the pointer "c" was first 
obtained by a call to alloc(). 
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ftoa() 


int ftoa(s, d, prec, type) /* Float to ASCII wy 
char *s; 

double d; 

int prec, type; 


Converts a floating point number "d" into an ASCII string and 
stores the result in "s". Up to 18 significant digits of preci- 
sion may be requested (i.e., prec = 18). The "type" variable may 
be 'g', ‘e' or 'f' [see discussion of the printf function]; 
otherwise the floating point number is free-form. Since the 
string is null terminated (i.e., '\0'), "s" must be large enough 
to hold "prec" bytes + 1 characters. 


fclose() 
int fclose(fp) /* close a file */ 
FILE *fp; 


Function first calls fflush() to flush the contents of the 
buffer and then closes the file associated with the "fp" file 
pointer. This frees "fp" for use with another file if desired. 


fFflush() 


int fflush(fp) /* write buffer to disk */ 
FILE *fp; 


Writes the current contents of the buffer associate with "fp" to 
the disk (including the EOF indicator). 
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fgets() 


char *fgets(s, i, iop) /* get string from file */ 
char *s; 
int i; 


FILE *iop; 


Reads "i" characters from iop and places them into the character 
array "s". The function terminates upon reading: (1) a null 
character ('\0'), (2) and end-of-file indicator, or (3) i-1l 
characters. The character string at "s" is null terminated ('\0') 
upon return. The function returns a pointer to the string, or 
zero if end-of-file or an error occurred. 


—fillbuff (© 


int _fillbuff (fp) /* read buffer of data */ 
FILE *f£p; 


Used to replentish the buffer associated with fp and returns the 
next character or EOF. 


fopen () 


FILE *fopen(name, mode) /* open file */ 
char *name, *mode; 


Open the file "name" for use in the "mode" file operation. There 
are two possible modes of operation: 


"r" Open for reading. The file must already exist to use 
this mode. ASCII text files have thecarriage-return, 
line-feed (i.e., <CR><LF>) adjustment. 


"rb" Open for binary reading. No <CR><LF> adjustments. 


"w" Open for writing. Any existing file with the same 
"name" is destroyed and a new file is created. The 
contents of the old file are lost. Does <CR><LF> 


adjustment. 


"wo" Open for binary writing. No <CR><LF> adjustments. 


Upon a successful open, the function returns a pointer (e.g., fp) 
to the opened file. If an error occurred, NULL is returned. (The 
"a", or append, option for random files is forthcoming). 
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fputs() 
int fputs(s, iop) /* Put a character out */ 
char *s; 
FILE *iop; 


Takes the character pointed to by "s" and puts it to the output 
designated by “iop". 


getc() 
int getc(p) /* Read character from file */ 
FILE *p; 


Reads a character from the input stream associated with "p". The 
character is normally returned as a positive integer although it 
may return EOF upon reading end-of-file or “ERR if an error 
occurred during the read. ou. 


getchar () 
int getchar() /* Get character from stdin */ 


Reads a Single character from stdin. stdin defaults to the 
terminal. 


gets () 
char *gets (buff) /* Get a string from sdtin */ 
char *buff; 


Get a string from stdin and place it in the buffer pointed to by 
"*buff". If input is from the console, '\r' is used to sense the 
end of the input string; otherwise a newline '\n' is used. 
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getw() 


int getw(£p) /* Get next word from file */ 
PILE | *£p3 


Reads the next word, or integer, from the file associated with 
fp. The word is returned if a successful read is done, but may 
also return EOF upon reading end-of-file or “ERR,if an error 


occurred during the read. NU whe 

hex () 
long hex(s) /* Return long from hexs */ 
char *s; 


Convert the hex string pointed to by "*s" into a long data type. 


isalpha() 
int isalpha(c) /* Is c alphabeticcharacter */ 
char c} 


If the character "c" is an alphabetic character, TRUE (i.e., 1) 
is returned; otherwise FALSE (i.e., 0) is returned. 


isdigit() 
int isdigit (i) {* Is da digit */ 


int i; 


If the character "i“ is a digit, TRUE (1) is returned; otherwise 
FALSE (0) is returned. 
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islower() 


int islower(c) /* Is c lower case letter */ 
char c; 


If the character "c" is a lower-case alphabetic character, TRUE 
(1) is returned; otherwise FALSE (0) is returned. 


isspace () 
int isspace(c) /* Is c white space */ 


char c} 


If the character "c" is a tab ('\t'), a space (' '), a newline 
('\n') or a carriage return ('\r'), TRUE (1) is returned; 
otherwise FALSE (0) is returned. 


isupper () 


int isupper(c) /* Is c in upper case */ 
char c; 
If the character "c" is an upper-case letter, TRUE (1) is 


returned: otherwise FALSE (0) is returned. 


octal () 
long octal(s) /* Return long of octal str */ 


char *s3 


Returns long of the octal string pointed to by "*s", 
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print£ 





Liter hs 





SPU Aa ra hts eat 





~ A minus sign before the conversion control character 
indicates that the output is to be left-justified. 


print£("$-d", x); 


will left-justify the contents of variable "x". 


m 


nn A digit string consisting of "nn" digits following the 
conversion character and preceeding the control 
charasre: sceecifies the minimum field width to be used 
for printing. If padding is required (i.e., number is 
amatlerthanthe width) blanks areusedunlessthe 


a] 


Filrgn Cisit is a zero which causes padding with zeros. 









printi("$i2da" » x). 


n “ 


praafe the variable "x" in a field of 12 positions. It 
may aiso he used with a decimal point: 





printf ("26.2£"; -x)> 


which prints in a field width of 6 places and reserves 
two places after the decimal point. 


eve 


eiag width specifier may also be used with string 





printf£("s25s", str); 
which prints the first 25 characters of the string 


variable “str” (right-justified). 


i States c the data item is a long rather than an int. 
(This is the letter “1", not a one). 





wrincn("$ld", x); 


Urs 


The conversion characters available are: 


ou 


Whe data iten is orinted in decimal notation. 
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oO The data item is printed in octal notation (unsigned). 


x The data item is printed in hexadecimal notation (un- 
signed)." PEL Fiics | 

u The data item is printed in unsigned decimal notation. 

c The data item is printed as a single character. 

8 Thedataitem is a String. The itemmustbenull term- 


inated or have a width specification equal to or less 
than the length of the string. 


e The data item is a float or double and is printed in 
scientific notation. Default precision is 6 digits, 
but may be modified with an "nn" specifier. 


£ The data item is a float or double and is printed in 
decimal notation with a default precision of 6 digits. 
The precision may be changed with an "nn" specifier. 


g Select the shorter of options e or f (i.e., use the 
one with the shortest width). 


The conversion characters may be in upper or lower case letters 
(they are converted to lower case during the parse of the control 
string). 


putc() 
int putc(c, p) /* Output a character */ 
char c}3 
struct iobbuf *p; 
Outputs the character "c" to the stream pointed to by "p" and 


returns the character "c". 


putchar () 
int putchar(c) /* Send character to stdout */ 


char ¢: 


Outputs the character "c" to stdout which is normally the con- 
sole. (This function calls putc() with "c" and stdout as its 
arguments.) 
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putw() 


int putw(lu, fp) 7* Output a word */ 
unsigned u; 
FILE *fp; 


Outputs the unsigned integer word "u" to the stream pointed to by 
"fp". This function is accomplished by calls to putc() with the 
lower byte sent first followed by the high byte. "Word" is taken 
to be two bytes in length. 


strcat () 


int strcat(s, t) /* Concatenate strings */ 
char *s, *t; 


The string pointed to by "t" is concatenated (i.e., added) onto 
the end of the string pointed to by "s". It is the programmer's 
responsibility to ensure that the character array pointed to by 
"s" is large enough to hold both "s" and the appended string at 
"ct" (including the NULL terminator '\0O'). 


strcmp () 


int stremp(s, t) 7/* Compare strings */ 
char. *s_- Ft; 


Compares the two strings "s" and "t" character-by-character. If 
the two strings match, a value of zero is returned. Otherwise, 
the function returns the result of the subtraction of the charac- 
ter in "t" from the character in "s". For example, if the match 
fails on the fifth character and s[4] = 'A' and t[4] = 'B', -1l is 
returned (i.e., 'A' in ASCII = 65, 'B' in ASCII = 66: therefore, 
-1 = 65 - 66). If follows that a negative value is returned if 
the ASCII value in "t" is greater than the ASCII value in "s", 
Positive values are returned when the ASCII value in "t" is less 
than the ASCII value in "s", 
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Assembly Language Functions 


The following is a list of assembly language functions that 
may be used. The are part of the EC2.REL disk file. They should 


be self-explanatory. 


double atof(s) 
char *s; 


int _bdos(val,call) /* 


int val,call; 


int _ftoa(s,db) /* 
char *s; 


double db; 


exit /* 


int open(s) /* 


char *s; 


int creat(s) /* 


char *s; 


int close(fd) /* 


int write(fd,buf,n) /* 


char *buf; 


7* Convert ASCII to float */ 


CPM BDOS call */ 


Convert double te ASCII */ 


Close files and end program */ 


Open file named str */ 


Create a file named str */ 


Close tile associated with td */ 


Write tc device */ 


/* if file i/o then n must be multiple of 128 */ 


int read(fd,buf,n) f* 


Char *buf; 


/* game note as write */ 


chain(s) /* Load and run a 


char *s;3 


char *sbrk (u) /* 


unsigned u; 


Read device */ 


program chain("filename") */ 


Return u bytes of storage */ 


Assembler Language Function Interface 


Assembly language routines may be written and called by the 
"C" program or other assembler language functions. There exist 
several Support routines that may be used to simplify assembler 
language interface. 


SRTN - will return the value pointed to by the HL 
register pair to the calling function. 


SRETVAL - will return the value contained in the DE 
register pair to the calling function. If 
a long waS requested then the value will 
be padded. 


SRETML - will return a -1 to the calling program. 

SFE ~ calls the function pointed to by the HL 
register pair using parameters following 
the call and information contained in the 
called function. 


$PPARM 


i 


pushes the parameter addressed in DE 
for the length in BC. 


When a function is defined, the first word in the function 
following the function name is the amount of stack space required 
for working storage by the function. This is expressed as a 
negative value. This stack space is the equivalent to auto 
variables. The code for the function immediately follows this 
word. For example: 


FAKE:: DEFW -8 
LD IX,0 
etc. 
LD HL,ANSWER 
JP SRIN## 


states that 8 bytes of working stack storage are required by the 
Function FAKE. The stack will always contain 8 bytes of 
administrative data prior to the requested storage. 
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The stack looks like this: 


aa saa lr aa aaa + OLD STACK 
| parameter n I 

tm --------~-------- +--+ + 

| parameter n-l I 
+---------------- ~~~ +--+ + 
++-~------~----~-~--~-----~-- + 

| parameter 1 | 
+--------------- ~~ + ++ + 

| requested working storage |! 
4+~-~-------------~---------- + 

| 8 bytes of administration | 

fonnn--- +--+ + CURRENT STACK 


The adminstrative data on the stack consists of the 
following: 


STACK ~ Address of where to return value. 
STACK+2 ~ Length to return. 
STACK+4 ~ Address of calling program. 


STACK+6 Address of old stack. 


Invoking a function in Assembler Language 


To invoke a function in assembler language the following 
convention is used. 


LD HL, FUNCNAME 

CALL SFERF 

DEFW old stack offset 

DEFW return value address offset 
DEFB return value length 


All offsets are positive. All return values must first be stored 
on the stack. For example, to do an assembler language call 
equivalent to the following "C" call 


double atof(); 
/7* code of some kind... */ 


a=atof (b); 


the equivalent assembler code is: 
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LD DE, @B saddress of B 


LD BC,8 glength of B 

CALL $PPARM## ;push it 

LD HL , ATOF# # j;address of ATOF 

CALL SFE## ;call it 

DEFW 8 ;offset for return valucw 
DEFW 8 70ld stack offsetm....... 
DEFB 8 slength to return | 


Using INIT.ASM 


The file INIT.ASM is used to change the number of iob's and 
fcb's and to set the stack pointer. To change the number of iob's 
and fcb's, change the number in the EQU statement to the desired 
number. To change the stack pointer, change the code that ini- 
tializes the stack. After INIT.ASM has been assembled, it must be 
linked in explicitly. For example: 


A>180 test,init,test/n/e<CR> 


Below is a copy of INIT.ASM modified for 10 files in 
addition to stdin, stdout, stderr, and stdlst. The stack has also 
been altered to reside at high memory. 


- 280 
INCLUDE FCB.MAP 
NFCB EQU 10 ;SET FILES TO 10 


INCLUDE FCB.ASM 
INCLUDE IOB.ASM 


CSEG 
SINIT:: POP BC 
LD HL, 0 ;SET STACK TO TOP OF MEMORY 
LD SP, HL 
PUSH BC 
LD HL, $FCB 
LD E,L 
LD D,H 
INC DE 
LD BC, NFCB*FCBL 
LD A,B 
OR Cc 
RET Z 
DEC BC 
LD (HL) ,0 
LDIR 
RET 
END 


27 


Remember that, when INIT.ASM is assembled, the following 
files must be available on the disk: 


FCB.MAP 
FCB.ASM 
IOB. ASM 


Naming Conventions 


In order to prevent conflicts with the assembler registers 
all variables of two characters or less have a prefix character 


of @. For example: 


A -> @A 
BC -> @BC 
Al -> @Al 


In addition to the above convention, all underscores are 
translated to question marks. For example: 


_AB -> ?AB 
A.B -> A?B 
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Creating Libraries 


Custom libraries may be generated for use with the Eco-C 
Compiler. What is presented here is an outline of the procedure 
necessary to establish your own library of C functions. Complete 
information is contained in your MACRO 80 documentation. 


First, each function to be included in the library should be 
compiled and assembled individually just as you would with any C 
program. The output from the assembler (M80) will be a series of 


At this point LIB80 is used to consolidate these files into 
a library. The following sequence of commands illustrates the 
creation of a library called OWN, containing two modules (.REL 
files) called ONE.REL and TWO.REL respectively. 


A>LIB80 <CR> 
*OWN=ONE,TWO <CR> 
*\E <CR> 


A> /* <--- Control returned to CP/M */ 


Note: in creating a library, the order of the modules is 
important due to a linker restriction. Any module which referen- 
ces an external label in another module must be included before 
the module containing the reference. For example, if file 
ONE.REL references a label in file TWO.REL, the above library 
generation is correct. 


On the other hand, if TWO.REL contained a reference toa 
label contained in file ONE.REL, the above library construction 
would cause an error message to be generated by the linker (L80). 
The linker makes only one pass through the libraries and there- 
fore will cannnot find any external label referenced ina file 
"in front of it" in the link sequence. 


When creating a library, you can request LIB80 to inform you 
of any unresolved errors the linker might encounter in searching 
the library. If you wish to check OWN for possible unresolved 
references, the sequence is: 

A>LIB80 <CR> 


*OWN/U <CR> 
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LIB80 will then list all unresolved references (i.e., globals). 


If you want a listing of the modules in a library with 
information concerning entry points and external references, the 
following command will cause that listing to be generated on the 
screen. 

A>LIB80 <CR> 
*OWN/L <CR> 


The LIB80 manual contains further information on how to use 
other commands to alter or create libraries. 
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CP/M I/O Interface 


Since the standard C library was written to exist in the 
UNIX environment, implementing the same library in a CP/M envir- 
onment presents several problems. In implementing the library 
for the Eco-C Compiler the following approach was used. 


To implement the file I/O as it exists in UNIX would require 
double buffering of all file I/0. This approach was considered 
too costly given the memory space available. Only single buffer- 
ing in the user's program is used. This buffer is the one created 
by fopen(Q) and pointed to by the associated _iob. 


The system routines, such as read(), write(), open(), and 
create() are contained in the user program but should be viewed 
as part of the operating system. In the UNIX environment, read() 
and writeQ) may have a count specification of any size when 
dealing with files. In the CP/M environment the count must be a 
multiple of a CP/M sector size (i.e. 128). The fcb's are main- 
tained by these "System" routines and contain information in 
addition to the fcb proper. It is intended that the fcb's be 
transparent to the user and therefore cannot be referenced by the 
user. 


The _iob's maintain a UNIX format and are defined in 
"stdio.h". An additional flag (_BFLAG) is used to determine if 
I/O is to do conversions on carriage-return, line-feed (CR LF). 
If the _BFLAG is set, no translation takes place. If the "_BFLAG" 
is cleared, the following translations take place. 


1. All input with the exception of _fd==0 will strip all 
<CR>'s from the input stream; it does not matter if a <LF> fol- 
lows. The other choice was to look for a <LF> and then do an 
ungetc() if it is not an <LF>. This would make ungetc() unreli- 
able for use by the program. The ungetc() function is only in- 
sured to work once, and this once was used by getc(), not the 
user. 


It was decided to make ungetc() available for the user 
program at the expense of an extra <CR> being stripped. In a file 
where this is critical, the program may be opened in binary mode 
(e.g., "rb" and "wb") which causes all <CR>'s processed by the 
user's program. 


2. When input is from _fd==0, a <CR> is taken as the end of 
input. At this point a <LF> is echoed to the screen and '\n' 
returned to the user program. 


3. On all output, ‘'\n' translates to <CR> <LF> and '\r' 
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Error Messages 


Any error in the source program is detected by the Syntactic 
Parser pass. To illustrate how this works, suppose you tried to 
compile the following "do-nothing" program: 


main () 


char wrong /* need semicolon at end of line */ 


Assume further that we have named this program ERROR.C. The error 
message generated will look like: 


Error in File: ERROR.C Line: 4 Char: 1 Error: 1002 Token: } 
Expected type specifier, typedef name, I[ ( 7; , 
) = or : instead of }. 


If you look at the program, we forgot to add the semicolon after 
the character variable named "wrong". The compiler found the 
character "}" when it expected to find something else. (A list of 
possibilities is given as part of the error message.) 


Since predictive parsing is used, we must look "backwards" 
from the point where the error was detected to find the error. 
Since the error was the first character inline 4, the error must 
have been caused by something near the end of line 3. Inspection 
of line 3 shows that we forgot the semicolon in the declaration 
of "wrong". 


Many of the messages will tell you what should have been 
found in the program where the error occurred. You will also note 
that some of the error messages have more than one number assoc- 
iated with them. This is so we can tell exactly where the mes- 
sages was generated within the error handler. 


You might want to write a few programs with known errors in 
them to "get a feel" as to how they are handled by the error 
handler. All errors are treated as fatal so there will be no 
cascading of false error messages. We think you will find that 
the error handler pinpoints the source of the error. 
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Error code Meaning 
Number (s) 


10 


ll 


12 


1009 


1011 


Internal Error - an attempt was made to create a temporary 
variable of an illegal type. Check source code for legality 
of statement. 


A type specifier, storage class specifier or function declar- 
ation was expected instead of ; 





A comma or semicolon was expected instead of 


1015 
An identifier, ( or * was expected instead of : 
A semicolon waS expected instead of : 
A closing parenthesis was expected instead of . 
An opening parenthesis was expected instead of . 
A closing brace waS expected instead of __. 
A closing bracket was expected instead of __. 
A parameter list was expected instead of _. 
1012 
An opening brace was expected instead of __. 


A parameter declaration list or opening brace was 
expected instead of 4 
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13 


14 


15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


The parameter declaration list is in error. 


An array size was expected but found __. 


A structure or union tag or opening brace was 
expected but found . 


A type specifier was expected but found F 


A statement or declaration was expected but found ; 


A type specifier or storage class specifier was expected 
but found . 





A storage class specifier was expected but found . 


An attempt was made to "goto" an illegal label name. 


An attempt was made to perform an illegal "break" or "continue" 


The "while" is missing from a "dof while" statement. 


A multiply defined "default" was found in the "switch". 


Multiply defined label. 


An identifier, opening parenthesis or constant was 
expected in the expression instead of 
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Par 


28 


29 


30 


31 


32 


33 


34 


35 


36 


37 


38 


Variable is undefined. 


Tllegal indirection or array reference. 


Expected a comma or closing parenthesis instead of : 


Internal Error - illegal multiplier. 


Illegal bitwise operand. 


Illegal pointer arithmetic. 


Illegal floating point operation. 


Illegal negation. 


Illegal logical not operation. 


Internal Error - illegal constant. 


Symbol multiply defined. 


Pointer is not to a structure or union in p->x or type 
initial field is not a structure or union in i.x. 


A subfield of the name referenced does not exist in the 
structure or union in i.sS Or p->s. 
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39 


40 


4) 


42 


43 


44 


45 


46 


47 


48 


49 


51 


52 


Input file not found. 


A colon was expected in ternary "?_:" but was not found. 


The results of the two expressions in ternary "?_:" were 


not of a legal combination. 


A non-zero integer constant was mixed with a pointer in the 
ternary "?_:" expression, 


Out of memory. 


Illegal address of (&id). 


WARNING - An extra opening brace was found and ignored. 


Illegal use of struct or union as source operand. 


Attempted assignment to a constant. 


Illegal assignment to structure, union, function name or 
array name. 


Attempt to "type" a parameter which is undefined in the 
function declaration. 


A structure, union or function data type was specified 
illegally. 


A referenced structure or union tag has not been defined. 
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54 


60 


1000 


1001 


1002 


1003 


1006 


1007 


1010 


i016 


An external data definition and the current data definition 
do not match. 


Initializers not currently supported. 


Expected type specifier, [ { 3; ) = or: instead of _._. 
A declarator Gelimiter (e.g, = , or ;), parameter declaration 
for a function or { was expected instead of __. 


Expected type specifier, typedef name, [ ( ; , 

) = or : instead of _. 

Expected type specifier, typedef name, [ {i ; , 

) = or : instead of __.. 

Expected identifier, * ( or : in structure or 

union declaration instead of . 

Expected ; s OF |» instead of _... 

Expected = ; or , instead of _._ in declaration list. 


Compiler doesn't handle function name as pointer yet. 
For nows 
Define variable as pointer to function 
then equate it to address of function name. 
i.e, a=éigetc; 


char 
unsigned 


double 
char 


int 
char 
long 
char 
int 
int 


char 
unsigned 


char 


int 
char 


int 
char 
double 
int 


Quick Function Reference 


*alloc(u) 
Uy 


atef (s) 


* 
5S? 


is) 


feve 


to 


g 


% 


bad 


atol(s} 
Kae 
> 


_bdos(val,caii) 
val,cail; 
Foalloofeount, size) 
Counk,S12e% 





¥: : a] 
ed RE, ay 
*s; 
dol 

% tye 
7 ‘ Crp 
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char 
char 


unsigned 
FILE 


long 
char 


int 
char 


int 
char 


int 
char 


int 
char 


int 
char 


long 
char 


int 
char 


int 
char 


int 
char 
FILE 


int 
char 


int 
unsigned 
FILE 


int 

int 

char 
char 

unsigned 
int 

char 


*gets (buff) 
*buff; 


getw(fp) 


hex(s) 
*s3 


isalpha(c) 
C; 


isdigit(c) 
CF 


islower (c) 
CF; 


isspace(c) 
CF 


isupper (c) 
C; 


octal(s) 
*S3 


open (s) 
*ss 


printf (control,arg,.. 
*control,*arg; 


putc(c,fp) 
C; 
*f£p; 


putchar (c) 
Ci 


putw(u, fp) 
u; 
*Ep; 


read(fd,buf,n) 
fd,n; 
*buf; 


*sbrk (u) 
u; 


Strcat(d,s) 
*d,*s; 


char 
char 
int 

FILE 


int 

FILE 
FILE 
char 
int 

char 
FILE 


int 
FILE 


int 


FO OND URW NH 
fo) 


ee 
Ne 


bh 
U1 of Ww 


e+ 1 
+v 


YV—M— OMA A + 
oo — & tt NN 
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*fgets(s,i,fp) 
*s;3 

i; 

*£D; 


_fillbuff (fp) 


*E£p; 


*f open (name,mode) 
*name, *mode; 


fputs(s,fp) 


*fp; 


getc(fp) 
*ED; 


getchar () 


Operator Precedence 
(Highest to lowest) 


~ 


int 
char 
int 
char 
int 
char 
int 
char 
int 
char 
int 
int 
char 


(cast) 


strcemp(d,s) 
*d,*s; 


strcpy (d,s) 
*d,*s; 


strlen(s) 
*s3 


tolower (c) 
CF 


toupper (c) 
Cc; 


write(fd,buf,n) 


fd,n; 
*buf;: 


& sizeof 


1 
> 

l 
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Software Problem Report 


If you encounter any errors that you believe to be in the 
Eco-C compiler, please report them as soon as possible. 


Eco-C License Number: 
Please describe your: 


Operating System: 


Computer (including amount of memory, disk drives, etc.): 


Please describe the problem as clearly as possible. If you 
can supply us with a copy on disk (8" SD if possible) of the 
program that produced the error, it will help us to correct it. 
Detailing the sequence of events leading up to the problem may 
also prove useful. If you are using some method of “getting 
around the problem", please describe it. We will try to correct 
any problems as quickly as possible. 
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